APPENDIX J 
SWITCH SUMMARIES 



J.l DSKINT Switches 



Switch 



/L 



Name 



List 



Example 
****NORMAL MODE SWITCHES**** 
#DP0:/L 



/M 



/R 



Enter 

MARK 

Mode 


#DP1:/M 


Retain 


#pP2:/V/R 



/v 



/z 



Verify 



Zero 



£DP:A 
#DP3:/Z 



/D 



Done 



****MARK MODE SWITCHES**** 
*65/M/D 



Operation 



Lists the contents of the 
BADE. SYS file at the prin- 
ter for the specified RP03 
disk. 

Changes DSKINT to MARK mode; 
DSKINT indicates MARK mode 
with * at the terminal. The 
RP03 will also be initialized. 

Retains BADE. SYS file on 
an initialized disk, and 
includes that informa- 
tion in the new BADE. SYS 
file when re-initializ- 
ing the disk. 

Verifies and zeroes an 
entire disk. 

Performs basic disk ini- 
tialization: 

a. Verify blocks and 
1, and any other 
blocks reserved for 
DOS/BATCH file struc- 
ture. 

b. . Zero the entire disk. 

c. Write file directories, 
bit maps, and BADE. 
SYS onto the disk. 
Enter [1,1] and the 
current UIC into the 
MFD. 



Causes DSKINT to leave 
MARK mode, but continue 
disk initialization; at 
c6mpletion, control re- 
turns to Monitor. 



Used in the following formats: bbbbbb/M (or U) and ccc:ttrss/M (or U) where 
bbbbbb is an octal block address; and ccc, tt, and ss are octal cylinder, track, 
and sector addresses. 



J-1 



Svritch Name 



/L 



/M^ 



/U^ 



List 



Mark 



Unmark 



Exampl e 
*DP0:/L 



M3/M 
*43:32:3/M 



^64AJ 

M7:4:2/U 

*73/M/U 



Operation 

Lists contents of BADE. 
SYS file at printer for 
the specified disk. 

Directs DSKINT to enter 
the BADE. SYS file at the 
specified address. 

Deletes a specified ad- 
dress from the BADE. SYS 
file, o£ ignores a pre- 
viously specified /M 
switch on a command line. 



J. 2 FILCOM Switches 
Switch Name 



Example 



****LOCAL SWITCHES**** 



Operation 



/EL 



Blank Lines 



When OFF, blank lines 
are compared in files; 
when ON, blank lines are 
ignored during compari- 
son. 



/DE 



Delete 
Existing 



/'ME 



Multiple 
Blanks 



/SC 



/'TR 



Source 
Compare 



TRciiling 
Blcinks 



When present, existing 
dataset of same name as 
that specified in com- 
mand is deleted; when 
not present, deletion is 
not performed. 

When present, reduces 
multiple blanks to a 
single space during com- 
parison; when not pres- 
ent, multiple blanks are 
compared individually - 

Specifies the number of 
consecutive lines to be 
compared to establish a 
successful comparison. 

When ON, trailing blanks 
are ignored during com- 
parison; when OFF, trail- 
ing blanks are compared. 



****GLOEAL SWITCHES**** 



/'DF 



Define 
DeFault 



Allows user to specify 
default conditions for 
one or more LOCAL swit- 
ches . 



Used in the following formats: bbbbbb/M (or U) and ccc:tt:ss/M (or U) where 
bbbbbb is an octal block address; and ccc, tt, and ss are octal cylinder, track, 
and sector addiresses. 



J-2 



Switch 
/IN 



/LO 



/LS 



Name 

INdirect 
commands 



LOg dataset 



List dataset 



Example 



Specifies dataset con- 
taining file to be read 
and interpreted as FIL- 
COM commands. 

Specifies log dataset 
for subsequent commands. 

Specifies list dataset 
for subsequent commands. 



J. 3 FILDMP Switches 



Switch 



/BL 



/CH 



Name 



BLock 



CHain 



****INPUT SWITCHES**** 
Example 
LP:<DT1:/BL:3:7 

KB:<DKj2f:FILE/CH 



Operation 

Dumps blocks 3, 4, 5, 6, 
and 7 from DTI to line 
printer in octal word 
format . 

Lists the numbers of the 
blocks which FILE occupies. 



/FA 



/FB 



Formatted LP ; <DK0 : FILE/FA 
ASCII 



Formatted 
Binary 



Unformatted 
Binary 



LP:<DF:FILE/FB 



LP:<DF0:FILE 



/AS 



ASCII 



****OUTPUT SWITCHES**** 
LP:/AS<DF:FILE 



/BY 



Octal 
BYtes 



LP:/BY<DKj2J:FILE 



Dumps FILE to the line 
printer in octal word 
format, but reads FILE 
in formatted ASCII mode. 

Dumps FILE to the line 
printer in octal word 
format, but reads FILE 
in formatted binary mode. 

Dvimps FILE to the line 
printer in octal word 
format, but reads FILE 
in unformatted binary 
mode . 



Reads FILE in unformat- 
ted binary mode and dumps 
to the line printer in 
ASCII mode; i.e., one 
ASCII character per byte. 

Reads FILE in unformat- 
ted binary mode and 
dvimps to the line prin- 
ter as a sequence of 
octal bytes. 
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Switch 
/OC 



/RA 



Name 

Octal 
words 



Unpacked 
Radix- 50 



Example 
LP:/OC<DF:FILE 



LP:/RA<DK0:FILE 



None 



Octal Words LP:<DK0:FILE 



OpeJ^ation 

Reads FILE in unformatted 
binary mode and dumps it to 
the line printer as a 
sequence of octal words. 

Reads FILE in unformat- 
ted binary mode and dumps 
it to the line printer in 
unpacked Radix-50 form 
format , i . e . , ' 3 charac- " 
ters per word. 

' Same as /OC. 



J. 4 FORTRAN Switches 

/AS and /LI may appear only on the output side of a FORTRAN command string. All 
other switches must eippear only on the input side. 



Switch 



Name 



Example 

****OUTPUT SWITCHES**** 



Operation 



/AS 



/LI:n 



Assembly 
Output 



List 
Control 



Produces assembly code - 
output instead of an 
object module; default 
filename extension is 
.PAL, not .OBJ. 

Default, n=l. 

n=0, lists block sum- 
maries only; 

n=l, source listing and 
block summaries; 

n=2, assembly code, source 
listing, and block 
summaries ; 

n=3, symbol table, as- 
sembly code, source 
listing, and block 
summaries. 



****INPUT SWITCHES**** 



/''CK 



/CO:n 



Check Bounds 



Continuation 



Checks all array sub- 
scripts for upper bound, 
as dimensioned in pro- 
gram. 

Sets maximum -allowable 
continuation lines; 
0<n<99; default, n=5. 
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Switch Name 

/ER Special Error 
Listing 



Example 



Operation 

Prints special advisory 
diagnostics (S codes) on 
questionable or certain 
non-ANSI statements. 



/GO 



Go 



/ON 



One 



Calls LINK after compila- 
tion for compile-load- 
go; any F error during 
compilation aborts this 
action and gives the 
message EXECUTION DELETED. 

Allocates one storage 
word (instead of two) 
for all integer and logi- 
cal variables. (PDP-11 
FORTRAN integers have 
only one word of preci- 
sion, even if two are 
allocated.) Use this 
switch carefully rela- 
tive to EQUIVALENCE 
statements . 



/OP:n 



Optimization 



/SU 



Suppress 



Generates code for the" 
most efficient hardware 
use; default, n=l. 

n=0, no optimization; use 
with TRACE. 

n=l, optimizes integer 
add and subtract 
operations , and 
array references. 

n=2, optimizes integer 

add, subtract, mul- 
tiply, and divide 
operations (requires 
PDP-11/1J2I, or PDP- 
11/20 with Extended 
Arithmetic Element, 
or PDP-11/40 with Ex- 
tended Instruction 
Set, or PDP-11/45) . 

n=3, optimizes floating- 
point arithmetic 
operations (requi- 
res PDP-11/45 with 
Floating-point Pro- 
cessor) , and inte- 
ger operations. 

Suppresses statement 
sequence numbers; saves 
two storage words per 
statement . Run-time 
error messages identify 
subroutine but not line 
number. 
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J. 5 LIBR Switches 



Switch 



Name 



E xample 



Operation 



/D Delete 

/D:vl. . . :vn 



/I 
/I:v 



/LO 



/R 



Insert 



List 

Object 

Module 



Replace 



#_DT1:LIBR.1<DT2:LIBR.0/D:M1:M2 Deletes one or more ob- 
ject modules (vl...vn) 
from the input library; 
do not use with /I or /R. 

#_DT1 : LIBR. KDT2 : LIBR. , FIL . l/1 : 2 , FIL . 2/1 

Inserts one or more ob- 
ject modules into the 
input library; v is a 
decimal integer relative 
to the input library; 
modules are inserted 
starting at position v, 
otherwise they are ap- 
pended to the end of the 
input library. 
Produces an object mod- 
ule listing to compare 
against an input library 
directory listing. 

#i:)Tl: LIBR. KDT2: LIBR. 0,FIL.1/R,FIL.2/R 

Replaces one or more ob- 
ject modules in the in- 
put library; the object 
modules must have the 
same name as the ones 
they replace. 



#_,LP sFIL.LST/LO<DTl :LIB. 1 



J. 6 LINK Switches 

LINK switches comprise three groups: input, map and load module output. The input 
switches are B, CC, E, EX, GO,, IN, L MP, 0, OD, T, and TR; the map switches are 
CR, LG, and SH; and the load module output switches are CO and SQ. 

Any extraneous value assigned to a switch is ignored. No switch except /OD should 
appear alone in an input specification; i.e., /E is illegal, but filename /E is 
legal. 



Switch 



/B:n 



Name 



Bottom 



E xample 

****INPUT SWITCHES**** 



Operation 



Controls placement or 
relocation of object 
program; n=unsigned oc- 
tal number that defines 
the bottom address of 
the object program. 
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Switch 



Name 



Example 



Operation 



/CC 



/E 



Concatenate 



End 



/EX : xxxxxx Exclude 



LIBRY/IN : ABC/EX : QKQ 



Indicates that a file is 
a concatenation of sev- 
eral files. 

Indicates end of input; 
should appear with last 
input file; should not 
be used with /GO. 

Excludes specified li- 
brary modules on library 
files; no effect if 
specified for nonlibrary 
files. 



/GO 



Go 



/IN : xxxxxx Inc lude 



FTNLIB/IN:$PSH01 



Indicates end of input, 
and, after linking, the 
loading and execution of 
the load module; should 
appear with the last in- 
put file, and should not 
be used with /E. 

Includes specified li- 
brary modules on library 
files; no effect if 
specified for nonlibrary 
files. 



/L 



Library 



/MP 



Overlay Map- 
ping Descrip- 
tion 



/O 



/OD 



Option 



ODT 



SY : DEBUG . LDA<S Y : ODT . OBJ [1,1] /OD 



Indicates that an input 
file is a library; not 
needed for correct li- 
brary functioning with 
LINK; provides compati- 
bility with old linker. 

.Specifies the associated 
file as an ASCII overlay 
description; no other 
input files, values, or 
switches (other than /E 
are allowed in a command 
string with this switch. 

Specifies that LINK op- 
tions are required; re- 
places /E. 

Links ODT with user's 
object modules; identi- 
fies associated input 
file as ODT for transfer 
addresses. Example shows 
equivalent of"/OD appear- 
ing alone as an input 
file. 
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Switch 



Name 



Excunple 



Operation 



/T:n 



Top 



/TR 

/TR:n 

/TR:xxxxxx 



Transfer 
Address 



Controls placement or re- 
location of object pro- 
gram; n-unsigned octal 
number that defines ad- 
dress of object program; 
default=top of available 
core. 

Without a value, directs 
LINK to take the trans- 
fer address (even or odd) 
of the first object mod- 
ule in the associated 
file as the transfer ad- 
dress of the load module. 
With n, uses value of n 
as transfer address of 
load module. With xxxxxx 
(global symbol) , uses 
value of symbol as trans- 
fer address of load mod- 
ule. (If xxxxxx does 
not exist, transfer ad- 
dress=l and an error 
message is issued.) 



****MAP SWITCHES**** 



/CR 



/LG 



Global 

Cross 

Reference 

Long Map 



/SH 



Short Map 



Produces global cross- 
reference table on map 
listing device. 

Produces long map form 
on specified map file; 
includes entry points, 
globals, and externals 
referenced by the module. 

Produces short map on 
specified map file; in- 
cludes only heading, 
program size description, 
and section allocation 
synopsis. 



****I,OAD MODULE OUTPUT SWITCHES**** 



/CO 
/CO:n 



Contiguous 
Output 



Specifies load module 
output file in contigu- 
ous format; required 
with overlaid programs. 

Using n (n=multiple of 
64) generates a contigu- 
ous file for another de- 
vice whose blocksize does 
not equal the blocksize 
of the current output 
device'. 
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Switch 



Name 



Example 



Operation 



/SQ 



Program 
Section 
Sequencing 



Stores program sections 
(.PSECT, .CSECT) in the 
order encountered by 
LINK, instead of alpha- 
betically. 



J. 7 MACRO Switches 

Switch options specified on the output side apply to both the object and listing 
files. Switch options specified on the input side apply to the file that precedes 
the switch and all subsequent files. 



Switch Name 



Example 



Operation 



/LI 



List 



/LI:arg List 



/NL 



/CRF 



Nolist 



/NL:arg Nolist 



/EN:arg Eneible 



/DS : arg Disable 



Cross- 
Reference 



#OBJFIL , LP : /LI<DTl : ABC 



ttOBJFIL, KB/LI : SRC,<DF : SRCFIL 



#OBJFIL , SYM/NL<ABC 



#0B JFIL , KB : /NL : BEX : COM< . 



# , LP : /CRF<FILE1 , FILE2 



Lists any source code 
normally suppressed. 

Formats the assembly 
listing to the argviment 
specified. 

Suppresses assembly 
listing. 

Deletes the portion of 
the listing indicated by 
the argument. 

Overrides any arguments 
specified on a .ENABL 
directive. 

Overrides any arguments 
specified on a .DSABL 
directive. 

Calls CREF immediately 
after assembly; prints 
both assembly and CREF 
listing at line printer 



/CRF: arg Cross- 
Re ference 



/PA:1 



/PA: 2 



Pass 1 



Pass. 2 



# , LP : /CRF : NG<FIIiEl , FILE2 



Postpones CREF action; 
prints only assembly 
listing and saves CREF 
listing creates FILE2.CRF 
containing CREF listing. 

Assembles file during 
pass 1 only. 

Assembles file during 
pass 2 only. 
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J. 8 PIP Switches 
Switch Name 
/AL Allocate 



/BR 



/CK 



/CO 



Brief 
Directory 



E xample 
#IDF:FILE/AL:10 

#DT0:/BR 



Checks\am #DT : /DI/CK 



Contiguous #I)T0 : <ABC/CO 



#DT0 : AD/CO<ABC , DEP 



/DE 



Delete 



#MAIN/DE 



#I)TjZf : ABC , DTI : DEF/DE 



/DI 



Directory #DT0:/DI 



/EN 



/FA 



/FB 



/FC 



/FC/VE 



/FR 



Enter 



Formatted 
ASCII 



Formatted 
Binary 



#DF:/EN 



#LP:/FA<DT0:ABC 



#DT0 : <ABC/FB 



Fast Copy #DT1:<DT2:/FC 



Fast Copy 
and Verify 



Free 



#_DT1:<DT2: /FC/VE 



#DT1:/FR 



Operation 

640 (10 X 64) contiguous 
words of file storage is 
allocated on disk. 

Lists all filenames and 
extensions in directory 
for DECtape on the 
user's teleprinter. 

Adds checksum information 
to each line of directory 
listings. 

Transfers file ABC as 
contiguous file from 
system disk to DECtape 0. 

Merges files ABC and DEF 
(on system disk) as one 
contiguous file on DEC- 
tape 0. 

Deletes file MAIN from 
system disk. 

Deletes files ABC and 
DEF from DECtapes and 
1 respectively. 

Lists all filenames, ex- 
tensions, size, creation 
date, and protection 
codes in directory for 
DECtape onto the user's 
teleprinter. 

Enters current user's 
UIC in MFD on the speci- 
fied' disk (device) . 

Copies file 7\BC from DEC- 
tape to line printer 
in formatted ASCII mode. 

Copies file ABC from sys- 
tem disk to DECtape 
in formatted binary mode. 

Data on DECtape #2 is 
fast copied onto DECtape 

#1. 

Data on DECtape #2 is 
fast copied and verified 
onto DECtape #1. 

Lists the number of free 
blocks remaining on DEC- 
tape unit 1. 
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Switch 
/IN 



Name 



Inspect 



/PR 



Protect 



Example 
#*.*/DE/IN 



#ABC/PR:355 



Operation 

Used in conjunction with 
file transfers and /SU, 
/DE, and /RE switches. 
Allows user to selective- 
ly perform the primary 
function. (User gives Y 
to perform action on the 
displayed file or types 
the RETURN key to leave 
file intact.) 

Change protection code of 
system disk file ABC to 
355. 



/RE 



Rename 



#ABC/RE<DEF 

£DT0 : GHI/RE<DT0 : JKL 



Rename file DEF to ABC. 

Rename DEC tape file 
JKL to GHI. 



/RU 



Rewind and 
Unload 



#MT1:/RU 



Causes the tape on mag- 
tape unit #1 to be wound 
back on it^ reel and the 
unit to be switched off- 
line. 



/RW 



Rewind 



#MT1:/RW 



Causes the tape on mag- 
tape unit #1 to be wound 
back on its reel. The 
unit can still be address- 
ed. 



/SU 



Supersede #dev:<devl:A,B,C/SU 



/UA 



Unformatted #LP:/UA<DT0:ABC 
ASCII 



Causes files on the input 
side (DEVI) to replace 
files of the same name 
which may already be on 
the output device (dev) . 

Copies file ABC from DEC- 
tape to line printer in 
unformatted ASCII mode. 



/UB 



/UN 



/VE 



Unformatted #pT0:<ABC/UB 
Binary 



Unlock 



Verify 



#DF: FILE. OLD/UN 



#DT1:<DT2:/VE 



/VW 



/ZE 



Verified 
Write 



Zero 



#CT : VW<CT1 : FILE . MAC 



#DT0:/ZE 



Copies file ABC from sys- 
tem disk to DECtape in 
unformatted binary mode. 

Unlocks FILE. OLD after a 
system failure so that 
FILE. OLD can be accessed. 

Data on DECtape #1 and 
DECtape #2 are compared 
block-by-block; disagree- 
ments are shown by prin- 
ting block and word num- 
bers at the console. 

Verify a write opera- 
tion by reading it after 
writing it. 

Erases all files from 
directory of DECtape 
by initializing the file 
structure . 
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J. 9 ROLLIN SWITCHES 



/DA : dd-mmm-yy Date 



/FI 



/FO 



Find 



Format 



Switch Name Example Operation 

/BO:dev Bootstrap #/BO:DK Bootstraps DOS /BATCH; loads the first 

256 words of core from the specified 
device and branches to location 0. 

|/DA:l-FEB-74 Enters specified date in FILE LABEL 
on magtape. 

Magtape use only: when reading, /FI 
rewinds the tape and searches for the 
specified file; when dumping, /FI 
skips all previously written files. 

Used on the output side of a transfer 
command string to format a DECpack 
cartridge on an RK03/05 disk drive, 
or a disk pack on an RP11-C/RP03 disk 
drive before the transfer operation 
begins . 

Help Types a brief explanation of ROLLIN 

options on the console. 

Nolabel When dumping disk to DECtape this 

switch inhibits the REEL LABEL from 
being written. 

Number n specifies the total number of units 

of disk space to transfer; a unit is 
IK pirocessor words (K=1024) ; n may 
assume a maximum value as shown here. 



/HE 



/NO 



/NU:n 



RCll 
RFll 
RKj2(3/05 
RP03 



64 

256 

12j2f0 

20000 



/PL:n 

/RW 

/SK:n 

/TR:n 

/VE 
/WL 



Platters 



Rewind 



Skip 



Track 



Verify 



Write Lock 



With RFll and RCll disks only, n is 
the number of disk platters to load or 
dump; default, n=l. 

Rewinds magtape before reading or 
writing. 

Skips past n end-of-file marks before 
starting to read or write on magtape, 

n specifies the unit of disk space at 
which to begin a transfer operation; 
see /NU for values n may assume; de- 
fault, n=0. 

Used in image copy operations to en- 
sure a correct and readable copy. 

Used with a DECpack device designator 
to force a write lock on an input drive 
unit . 
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